home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 018a / macade41.zip / HISTORY.DOC < prev    next >
Text File  |  1991-08-15  |  13KB  |  287 lines
  1.  
  2.  
  3.                      - MacroAde, Version 4.1 - HISTORY.DOC -
  4.  
  5.  
  6.                 M a c r o A d e
  7.                    -----------------
  8.  
  9.                                   Version 4.1
  10.                  -------------
  11.  
  12.               U P D A T E     H I S T O R Y
  13.              ------------------------------
  14.  
  15.  
  16.           Copyright (c) 1991 by Jeffrey S. Kane, Ph.D.
  17.                   All Rights Reserved.
  18.  
  19.  
  20.                           Last updated:  August 15, 1991
  21.  
  22.  
  23.       This document describes the changes and corrections made to
  24.       MacroAde with each version.  Versions are listed in reverse
  25.           chronological order (most current version first, original version
  26.           last).
  27.  
  28.                  **********************
  29.  
  30.  
  31. August 15, 1991, Release of Version 4.1:
  32.  
  33.          Several comments, particularly those from one of CompuServe's
  34.          Sysops, instigated some changes in how the MCompile program
  35.          handles space (ASCII 32) characters.  The program now requires
  36.          all literal spaces (i.e., spaces to be represented as spaces
  37.          in the compiled macro) to be entered in the text file as
  38.          either ASCII 250 characters or by the [:0,250] character code
  39.          (if ASCII 250 is inaccessible to one's editor).  With one
  40.          exception all other instances of ASCII 32 characters in
  41.          the text file are either converted to tabs (if they are in
  42.          a sequence of 3 or 4) or are ignored.  The one exception are
  43.          occurrences of single spaces between two non-space characters.
  44.  
  45.          Hard line-endings are represented in macros as ASCII 13 and
  46.          soft endings as ASCII 10.  Previous versions of MacroLst only
  47.          recognized ASCII 10 as an end of line.  This has been corrected.
  48.  
  49.  
  50. August 8, 1991, Release of Version 4.01:
  51.  
  52.         This release fixes several bugs and inconveniences in some of the
  53.         programs.  The EditWP and EditM macros for editing macros
  54.         within WordPerfect didn't work as smoothly as they should have and
  55.         their operation has now been improved.  A particular problem that
  56.         was fixed was EditWP's use of Doc 1 rather than Doc 2 to edit macros
  57.         as WordPerfect documents.  This has been corrected.  MCompile's
  58.         inability to detect the end-of-file when there was no end-of-line
  59.         sequence after the last element in a file has also been fixed.
  60.  
  61.  
  62. August 2, 1991, Release of Version 4.0:
  63.  
  64.      The MOST COMMON error made in developing WordPerfect macros, both
  65.      by experts and by novices, is the omission of tildes (~).    Leaving out
  66.      tildes is an insidious error because even one missing tilde can make the
  67.      macro appear to have major logic problems and lead you astray in your
  68.      search for a bug.    Moreover, the blind spot in your programming that
  69.      led you to leave out a tilde initially often prevents you from finding
  70.      it by a manual check.  Unfortunately, up to now there has been no way to
  71.      check for missing tildes other than manually.  TILDECHK fills this gap.
  72.      Running it on macro source files conforming to the format used by
  73.      this package's MacroLst program will produce a listing of the line numbers
  74.      and initial macro commands of the sequences in which tildes are missing
  75.      in your macro.  TILDECHK will save you hours of time, even when it only
  76.      confirms that you have no missing tildes and that your bug must be in
  77.      logic or other syntax.
  78.  
  79.          Speaking of missing tildes, I left one out in the entry for the
  80.      {FOR EACH} command in the COMMANDS.REF file.  This has been corrected.
  81.  
  82.  
  83.  
  84.       MacroAde Update History                 Page 1 of 5
  85.  
  86.  
  87.                      - MacroAde, Version 4.1 - HISTORY.DOC -
  88.  
  89.  
  90. July 28, 1991, Maintenance Update of Version 3.0:
  91.  
  92.      MacroAde Version 3.0 archives of this date contain a version of the
  93.      AltL macro menuing system that has had a bug fixed in its ability to
  94.      restore a system's original cursor speed.  If you want your cursor
  95.      speed in WordPerfect to be restored to any value other than "Normal",
  96.      you must specify this in the header of the AltL.wpm macro by editing it
  97.      either with your own editor or with the Ctrl-F10, Edit function in
  98.      WordPerfect.  In previous releases, any value other than "Normal" was
  99.      ignored, despite its having been changed by the user.  This has now been
  100.      fixed.
  101.  
  102. July 6, 1991, Release of Version 3.0:
  103.  
  104.      1. AltL.wpm, the advanced macro menuing system:
  105.          * Several bugs reported by users were fixed, including:
  106.             ** occasional wiping out of top line formatting
  107.                 information in document from which AltL was
  108.                 accessed.
  109.             ** incorrect specification of ESC rather than CANCEL
  110.                 as the key to use to exit from menu; it now
  111.                 exits with either ESC or CANCEL.
  112.             ** menu entries getting a bit scrambled when AltL was run
  113.                 while Reveal Codes was activated; I couldn't
  114.                 figure out why this was happening, so I simply
  115.                 have the macro turn off Reveal Codes if it is
  116.                 active when AltL is invoked.
  117.  
  118.          * The editing functions for the entry of descriptions of macros
  119.             listed as menu items have been both improved and made much
  120.             more bullet-proof.    Improvements include adding of insert,
  121.             delete, home, and end functions.  Bullet-proofing entailed
  122.             ensuring that no editing function could move any portion of
  123.             the description outside of the 64-column range allowed for
  124.             it.
  125.  
  126.          * At the suggestion of a Sysop from one of the major BBSs, a
  127.             small change was made to the SHELL command in this macro
  128.             which should enable AltL to run under WordPerfect Office's
  129.             Shell.
  130.  
  131.      2. The same minor change to the SHELL command as above was also made to
  132.          the occurrences of this command in Bringbak.wpm, EditWP.wpm, and
  133.          EditM.wpm to enable those programs to run from within the Office
  134.          Shell environment.
  135.  
  136.      3. Movecsr.wpm, macro to position cursor in advance of another macro:
  137.          * The status line prompt for this macro was changed from 2 lines
  138.              to one to prevent the top line from floating up into the
  139.              document in which the cursor is being moved.
  140.  
  141.  
  142.       MacroAde Update History                 Page 2 of 5
  143.  
  144.  
  145.                      - MacroAde, Version 4.1 - HISTORY.DOC -
  146.  
  147.  
  148. Version 2.0, Release Date: June 22, 1991:
  149.  
  150.      1. Macrolst.exe, the macro-to-ASCII translator/decompiler:
  151.          * now accepts macro (.wpm) files of unlimited size as input;
  152.             formerly, the program choked on macros bigger than 15K
  153.             or so.
  154.          * translates any literal braces ("{}") found in macros to
  155.             their character set representation ([:0,123] or [:0,125])
  156.             in the ASCII file in order to permit them to be recompiled
  157.             successfully.  This is the only lower ASCII character so
  158.             treated.
  159.         * now recognizes several commands ignored in previous version:
  160.             {Key Macro },Shift F11 & F12, ALT F11 & F12,
  161.             Ctrl F11 & F12, {Compose}.
  162.         * COMMANDS.ref has been updated.
  163.  
  164.      2. MCompile.exe, the ASCII-to-macro compiler:
  165.          * now accepts source files of unlimited size as input; as with
  166.             Macrolst, it formerly choked on macros bigger than 15K.
  167.          * case insensitive command syntax: macro and keystroke commands
  168.             may now be entered without regard to the upper or lower
  169.             case of the characters in the commands.
  170.          * handles either spaces or tabs as formatting characters (i.e.,
  171.             to produce indents) at the beginning of lines in the
  172.             source file.
  173.          * allows the use of lit22eral braces in the source file, but only
  174.             when represented in character code form
  175.             (i.e., "{" = [:0,123] & "}" = [:0,125]), not directly as
  176.             ASCII characters.
  177.          * now recognizes several commands ignored in previous version:
  178.             {Key Macro },Shift F11 & F12, ALT F11 & F12,
  179.             Ctrl F11 & F12, {Compose}
  180.  
  181.      3. EditWP.wpm -- use WordPerfect as a macro editor:
  182.          * a macro that works in conjunction with a batch file
  183.             (EditWPM.bat), Macrolst, and MCompile to bring macros of
  184.              any size into WordPerfect for editing as WordPerfect
  185.              documents and, upon pressing EXIT (F7), recompiles the
  186.              document back into a macro ready for use.
  187.          * includes error checking during compilation and return to the
  188.              editing process (at user's option) if any syntax errors
  189.              occur during compilation.
  190.          * includes a utility macro, BOLDCMDS.wpm, that bolds all macro
  191.              and keystroke commands after conversion to a WordPerfect
  192.              document, matching the screen image of the internal macro
  193.              editor exactly.
  194.  
  195.  
  196.  
  197.       MacroAde Update History                 Page 3 of 5
  198.  
  199.  
  200.                      - MacroAde, Version 4.1 - HISTORY.DOC -
  201.  
  202.  
  203. Version 2.0, Release Date: June 22, 1991 (continued):
  204.  
  205.      4. BringBak.wpm, the system for importing external data into WordPerfect:
  206.          * the external .exe program that was used to bring data back into
  207.             WordPerfect, BringBak.exe, is replaced by two alternative
  208.             programs which give this process much more flexibility.
  209.             Both of these programs now allow the name of a file
  210.             containing the data to be imported to be specified on the
  211.             command line, preceded by an @ sign.  This avoids having
  212.             to manually enter the data on the command line and allows
  213.             external processes to write their data to a file for
  214.             importation.
  215.  
  216.             ** AutoBak.exe: issues an EXIT command upon termination
  217.                 for automatic return to WordPerfect.  This is not
  218.                 needed, however, if only a single DOS command
  219.                 (even a batch file name) is issued rather than
  220.                 a full SHELL to DOS.  Moreover, it may not be
  221.                 desired if something else needs to be done
  222.                 externally after the data is sent back.  Thus,
  223.                 a second version...
  224.             ** USendBak.exe: does NOT issue an EXIT command upon
  225.                 termination. The user must issue an EXIT or place
  226.                 one in the batch file to return to WordPerfect,
  227.                 thus giving the user much more control over
  228.                 external event processing.    See example in
  229.                 EditWPM.bat.
  230.  
  231.          * Two small macros excerpted from BringBak.wpm have been added
  232.             (SetNV.wpm and ParseNV.wpm) which allow the user to set up
  233.             an importation variable in another macro ({NEST}SetNV~),
  234.             SHELL to DOS and bring back up to the usual 120 bytes of
  235.             data, and parse out the data and put it in NewVar
  236.             ({NEST}ParseNV~) for use within the macro.    This technique
  237.             is exemplified by the EditWP.wpm macro.
  238.  
  239.          * The message displayed on the status line informing the user
  240.             that the imported data is now in the NewVar variable
  241.             disappears after any key is pressed.
  242.  
  243.      5. AltZ.wpm - "On beyond Z" in the use of ALT + letter keys to
  244.          invoke macros:
  245.          * Have you run out of keys for ALT-invoked macros?  Here's a
  246.             simple macro solution that many others have undoubtedly
  247.             come up with but which is offered here to those who may
  248.             have missed anything like it up to now.
  249.          * ALTZ allows you to use ALT Z plus any of 54 other ASCII
  250.             characters to invoke a macro you've named ALTZ?,
  251.             where ? = its identifying ASCII character of your choice.
  252.          * Changing the Z in ALTZ.wpm and in all occurrences within the
  253.             ALTZ.wpm macro file itself to any other character will
  254.             allow you to have additional easy-to-invoke macros in
  255.             case you run out of keys to use with ALTZ.
  256.  
  257.  
  258.       MacroAde Update History                 Page 4 of 5
  259.  
  260.  
  261.                      - MacroAde, Version 4.1 - HISTORY.DOC -
  262.  
  263.  
  264.  
  265. Version 1.0, Release Date: June 14, 1991:
  266.  
  267.     1. The most obvious change in this first update is to the new name of
  268.        the product from MacroAid to MacroAde. This was done to eliminate
  269.        redundancy with the use of the former name for a product published by
  270.        Software by Seidman.
  271.  
  272.     2. A bug was fixed that prevented both the Macrolst and MCompile programs
  273.        from properly handling the "{Macro Commands}" macro command.  These
  274.        programs now translate and compile this command correctly.
  275.  
  276.     3. An explicit note was added to the MCompile documentation which points
  277.        out the reserved status of the French braces characters ({}).  These
  278.        characters may only be used to enclose macro or keystroke commands in
  279.        order for the compilation of a source file to proceed.    They may not
  280.        be used as literals.
  281.  
  282.  
  283.  
  284.       MacroAde Update History                 Page 5 of 5
  285.  
  286.  
  287.